Delphi 2.0 - Programmer's Utilities Power Pack/Delphi 2.0 Programmer's Utilities Power Pack.iso/m_to_r/magicdem/read.me

Text File | 1996-09-15 | 16.8 KB | 472 lines

MAGic & Magic Deluxe User's Guide

Revision 1.17 Release II
─────────────────────────────────────────
Note: See the READ-DLX.ME file for information on MAGic Deluxe Operation
      in addition to this document.

MAGic ($79) -MAGnification In Color is software which provides 2x2 text
and graphics magnification ── in a tiny 7K memory resident size!!  MAGic is
compatible with DOS based PCs equipped with VGA, XGA, or SVGA video systems.

MAGic Deluxe ($195) is a 12K TSR & Magnifies 1.4,2,4,6,8,12 times. READ-DLX.ME
has details on operation specific to the Deluxe version which is additive to
this Document. The Deluxe versio also magnifies Graphics 2x.

The demo version of MAGic is restricted to 20 minutes of operation.  Once you
have experienced MAGic's power and ease-of-use, you can register the demo copy
via telephone.  Microsystems Software can be contacted at any of the following
numbers:

MAGic & MAGic Deluxe are members of the HandiWARE family of affordable
adaptive access software.

VOICE: [phone] FAX: [phone] BBS: [phone] This section
describes the process of loading, unloading and operating MAGic.  If you have
not already installed MAGic, please refer to Section 2 ─ Installation and
Registration.


Loading MAGic

If you instructed MAGINST to auto-matically load MAGic whenever your PC is
reset, MAGic will always be running in the background mode and can be accessed
at any time, without exiting your application programs.  If you did not
instruct MAGic to automatically load, you can load it now by inputting the
following from the DOS prompt:

MAGIC <Enter>

Command Line Options

When loading MAGIC you can optionally specify one of the following command
line options:

/? Help

The /? option will display MAGic's Help screen.  /C Use <Ctrl> hot-keys not
<Alt>

Use <Ctrl-Spacebar> and <Ctrl-5> instead of <Atl-Spacebar> and <Alt-5>. To
invoke the type-thru mode.

/M Load Magnified

Normally, when MAGic is loaded, it displays its sign-on screen then returns to
the DOS prompt.  In order to invoke the magnified operation, you must manually
press one of the magnification command keys.

The /M option instructs MAGic to load into memory and automatically invoke the
magnification mode.

/U Unloading MAGic

To unload MAGic from memory, input the following command from the DOS prompt:

MAGIC /U

Note that if any other memory resident program(s) were loaded after MAGic, you
will not be able to unload MAGic until you unload the other program(s). ALSO..
The Unregistered MAGic (20-minute demo) will not unload with the /u.  You must
re-boot your computer.


MAGIC /C+    Use CTRL Keys for DesqView Operation

Invoke Magic using the /C+ option.  This will now use the CTRL key at any
time that it normall would use the ALT key.  ie. CTRL-Space will Magnify
and holding CTRL while moving the mouse will move the magnified area of the
screen.  This avoids conflicts with the DesqView ALT (Task Switch) key useage.



MAGic Operation

MAGic is EXTREMELY easy to use!  Once MAGic has been loaded, it resides in the
background on your PC until you press one of its hot-keys.  The remainder of
this section discusses MAGic's operation.


Magnification On/Off

MAGIC provides both type-thru and command mode magnification.  The following
describes the type-thru operation.  The command mode operation is discussed
later in this section.  The following functionally identical hot-keys are used
to toggle on/off magnification in the type-thru mode:

<Alt-Spacebar> or <Alt-NumPad-5>

If you used the /C command line option.  The hot-keys are <Ctrl-Spacebar> &
<Ctrl NumPad-5>

Pressing either of these keys while in standard video mode will magnify the
screen.  If you are already in the magnification mode, pressing one of these
keys will return the PC screen to the standard size.  Magnification Modes

MAGic provides 2 basic modes of magnified screen display: boxed and stacked.

In boxed mode, MAGic displays 14 lines by 40 columns (approximately 1/4 of the
PC's full screen).

In stacked mode, the right-hand 40 columns of a line are "stacked" beneath the
left-hand side of the line.  In this mode, MAGic uses the 14 lines to display
7 lines of 80 column information.  The stacked mode might look a bit odd at
first, with words split between the 2 lines.  However, with time you may find
that this is a useful way to read existing text without the need of panning
around the screen.

Each time it is invoked, MAGic defaults to its boxed mode.  The following
command key is used to toggle between boxed and stacked display modes:


<Shift-NumPad +>

NOTE: This is the gray + key on the numeric keypad.  Moving Around the Screen

MAGic's 2x2 magnification means that you can only see 40 columns and 14 lines
at any one time.  In addition to the stacked mode described above, MAGic
provides 2 basic methods of moving around the screen: on-line and off-line
tracking.

MAGic's on-line tracking facility automatically follows your cursor movement,
on-screen attribute changes (i.e. color changes) and mouse movement, as you
work in within text based application programs.  Additionally, it follows the
mouse movement in graphics applications.

MAGic's off-line tracking facility lets you move around the screen image
without effecting your foreground text or graphics application program:

<Shift Up/Down Arrow> Move to the previous / next line.

<Shift L/R Arrow> Move to the previous / next column.

<Shift-PgUp> Move to the first line in the current column.

<Shift-PgDn> Move to the last line in the current column.

<Shift-Home> Move to the first column in the current line.

<Shift-End> Move to the last column in the current line.



Mouse Operation

If your application program uses the mouse, MAGic will attempt to center the
screen around the mouse cursor as you move around the screen.  Additionally,
mouse users can also use the following facilities:

<Left-Alt> + mouse movement Move around the screen, without moving the
mouse cursor or effecting your foreground application program.

<Left-Alt> + the Left mouse button Toggles magnification on/off.

<Left-Alt> + the Right mouse button Toggle between MAGic's stacked and
boxed display modes.  MAGic's Command Mode

MAGic provides a powerful command mode.  The command mode provides some
special MAGic command keys, plus it is useful for browsing around the screen
without needing to hold down the <Shift> key.  Since some programs (such as
Word Perfect) do not let MAGic receive the <Shift-Cursor keys>, you may find
it is necessary to move to the command mode while browsing.

To invoke MAGic's command mode, press:

<NumPad-5>

Note that <Num Lock> must be OFF to invoke the command mode.

The following feature are available in the command mode:

<Up-Down Arrow> Move to the previous / next line.

<Left-Right Arrow> Move to the previous / next column.

<PgUp> Move to the first line in the current column.

<PgDn> Move to the last line in the current column.  <Home> Move to the first
column in the current line.

<End> Move to the last column in the current line.

In addition to the browsing command keys, the command mode also provides the
following advanced command options:


<I> Track invisible cursor

This option toggles the state of MAGic's hidden cursor tracking.  Some
programs use an invisible cursor.  Even though you cannot see this cursor,
MAGic can. Normally, MAGic WILL NOT track invisible cursors.  This command is
used to enable/disable the tracking of an invisible cursor.  Pressing I once
will disable this tracking; pressing it a second time enables this tracking.

<M> Track Invisible Mouse cursor

As with the invisible cursor, MAGic is able to track an invisible mouse.  This
command is used to enable/disable the tracking of an invisible mouse cursor.
Normally, MAGic DOES track invisible cursors.  Pressing M once will enable
this tracking; pressing it a second time will disable this tracking.

<Ctrl-Arrows> Adjust screen bias

This command adjusts the bias of the upper left corner. This is useful for
some graphics programs.

<Enter> Type-thru mode @ cursor

Enter type-thru mode at the cursor.

<Ins> Type-thru @ current location

Enter type-thru mode at the current screen location.

<NumPad-(Plus +)> Stacked/Boxed modes

This toggles between the stacked and boxed modes.  For more information,
please refer to page .  Command Mode Mouse Control

When in the command mode, the mouse functions as follows:

Mouse movement Move around the screen.

The Left mouse button Invokes MAGic's type-thru mode.

The Right mouse button Toggle between stacked and boxed modes.



Windows Operation

To use MAGic with Windows 3.0 in the Enhanced, Standard or Real modes, run
MAGIC.EXE from DOS before loading windows, then select the MAGic icon from
within Windows.  For information on using the WINSTART.BAT file, please refer
to .

If you added WINMAGIC.EXE to the RUN= line in your WIN.INI file, it will be
automatically loaded each time you run Windows.  If you did not use Windows
auto-run facility, simply double click on the MAGic icon to load it.  As soon
as Winmagic is loaded, it puts your screen in magnified mode and places a
MAGic icon on your desktop.

To toggle between magnified and non-magnified modes, simply double click on
MAGic's desktop icon.

For those who have not upgraded to Windows 3.0, a WIN2MAG.EXE is included on
the distribution diskette for operation under Windows 2.X


Advanced Programmer's Interface

To provide utmost compatibility for MAGic and software currently under
development, Microsystems Software includes the necessary programming
interfaces within the MAGic distribution diskettes.  To access this
information, locate the API.DOC file.  For further information or assistance,
please contact MSI at [phone].

We have also provided an adaptive access trigger for the TSR <ALT-7> scan code
0x7E00 which operates identically to the NumPad-5.  This allows programs such
as Dragon Dictate, Voice Connexion, and HandiWARE Products to selectively
control MAGic.


In Case of Difficulties

MAGic has been designed to be as flexible as possible and to co-exist with
most PC programs.  If, however, you should find that you have difficulty
getting MAGic to function properly in your environment, please contact MSI or
an authorized distributor directly to report any incompatibilities.  We will
be happy to look into them for you.  Thank you for purchasing a Microsystems
Software product.  We hope you enjoy MAGic!

MAGic Installation & Registration

─────────────────────────────────────────



Installing MAGic software

Your MAGic package contains two master distribution diskettes, with identical
files, one 5.25" and one 3.5" diskette.  Place the appropriate diskette in
your A:floppy drive and input the following:

A:MAGINST <Enter>

If you want to use the B: floppy use B:MAGINST instead

MAGINST will now prompt you with the following questions:

Source drive

Input the letter of the drive that contains the MAGic distribution diskette,
then press <Enter>.

Destination drive

Input the letter of the drive to which MAGic should copy its files to, then
press <Enter>.

Path name

Input the PATH which will contain the MAGic files.  We recommend that you use
the default directory name - \MAGIC.  When you have Entered the desired
directory name, press <Enter>.

Is the drive and directory above correct (Y/N)

If you would like to change any of the above, press N.  Otherwise press Y to
begin copying MAGic's files.

MAGic already exists in this directory.  If you would like to upgrade the
MAGic program, press "U".  To completely re-install MAGic's program, press
"I".  Press <Esc> to abort:

This message will only appear if MAGic was previously installed in the
specified directory on your hard disk.

If you want to completely install a new version of MAGic, press 'I'.  If you
are not sure which option you want, press <Esc> to abort the installation
process.

This copy of MAGic has not been registered.  MAGic will be installed as a 20
minute demo.  If you would like to purchase the product call MSI at (508)
626-8511.  Strike <Esc> to Abort, or <Anykey> to continue.

This message appears only if you are installing a demonstration copy of MAGic.
You can upgrade a demo copy of MAGic to a full unrestricted copy at any time
by contacting MSI or an authorized distributor.

Would you like MAGic loaded every time your computer is booted (Y/N):

Responding 'Y' will instruct MAGINST to add MAGic's program name to your
AUTOEXEC.BAT file.

Would you like to be able to start MAGic from any directory on your computer?
(Y/N):

Responding 'Y' will instruct MAGINST to add MAGic's directory name to your
AUTOEXEC.BAT PATH statement.  Once this is done, you will be able to load
MAGic at any time, without need to first log into the MAGic directory.

Could not locate AUTOEXEC.BAT on drive C. What drive is it located on? <Enter>
for drive A, <Esc> to Create new on drive C:

This message will only appear if you responded with a 'Y' to either of the 2
previous questions, and MAGINST could not find your PC's AUTOEXEC.BAT file on
the root of your C:drive.  If it finds this file, MAGINST will make the
appropriate modifications.  If MAGINST does not find the AUTOEXEC.BAT file, it
will display this message.

If you respond 'Y' then MAGINST will load MAGic.  If you respond 'N' then
MAGINST will return you to the DOS prompt.

Installing MAGic for Windows

Your MAGic package includes a copy of WINMAGIC.EXE ── MAGic's native Windows
3.x magnification facility.

Add WINMAGIC.EXE as a program in one of you program manager groups.  To add a
program to a group in the Program manager, single click on the desired group,
select File, New, Program Item and Ok.  the currently highlighted.  Next
select Browse, the Winmagic drive, path and program name and Ok.  The Winmagic
icon should now be displayed in the currently program manager group.

If you would like WINMAGIC to be automatically run each time you load Windows,
simply add the program path and file name to the RUN= line in your WIN.INI
file.

Note that MAGIC.EXE must be loaded in DOS BEFORE loading MAGic.  If you do not
have MAGic automatically loaded each time your PC is powered up or reset, we
recommend that you create (or update) a WINSTART.BAT file in the Windows
directory and add the MAGIC program name.  WINSTART.BAT is automatically
loaded each time you run windows.  Therefore you can assure that MAGic will
always be available when in Windows.

MAG-REG.EXE

If you have obtained a 20 minute demo of MAGic and wish to purchase the
product, MAG-REG.EXE is a registration facility that allows you to register
MAGic over the phone and remove the time restrictions.


MAGic Video System Support

─────────────────────────────────────────

MAGic has been developed to be compatible with virtually all VGA, XGA, and
SVGA video systems (i.e resolutions from 640x480 to 1024x768).  MAGic's
sophisticated video management technology, automatically senses your PC's
current video resolution and self-adjusts its parameters.  This means that
MAGic does not require a configuration menu.

Text Mode Support

MAGic supports the following text mode environments that are set by various
application programs:

Supported Resolutions:

40 x 24 Additional Magnification to double height 80 x 12 Additional
Magnification to double width 80 x 14 Additional Magnification to double width


80 x 21, 80 x 25, 80 x 28, 80 x 43, 80 x 50

132 x 25, 80 x 28, 80 x 43, 80 x 44, 80 x 50


Graphics Magnification

MAGic supports the following graphics mode environments set by various
application programs.

Supported Modes:

320 x  200  x  256
640 x  200  x  2            2 x Horizontal Mag. Only
640 x  350  x  1/16
320 x  400  x  256
360 x  480  x  256
600 x  800  x  16/256
640 x  200  x  16           2 x Horizontal Mag. Only
640 x  400  x  256
640 x  480  x  2/16/256
720 x  480  x  256
800 x  600  x  16           TSENG 3000/4000
1024 x 768  x  16           TSENG 3000/4000
1024 x 768  x  16           Paradise
1024 x 768  x  16           ATI Wonder

Non-supported Modes:

320 x 200 x 2  Mono-CGA
320 x 200 x 16 Color-CGA


The license agreement which is included with this product specifies the rights
of use.  Unauthorized duplication of this product in any medium is strictly
prohibited.

Notice of Change

All information contained in this document is subject to change without
notice.

Copyright 1991 Microsystems Software Inc.

600 Worcester Road Framingham, MA 01701


Software by: Ratko Tomic

MAGic, HandiWARE, HandiWORD, HandiCODE, HandiKEY, HandiTALK, HandiCHAT,
HandiVIEW, HandiSHIFT and SeeBEEP are trademarks of Microsystems Software,
Inc.


MAGic User's Guide

Revision: 1.16A

May, 1991